===========================================
| Raptor007's Falcon 4 to X52 Pro Utility |
| Version 1.4 (2010-03-28)                |
|                                         |
| http://www.raptor007.com/               |
| blair@datapro.net                       |
===========================================


This program was written by Raptor007 (Blair Sherman).  Email me or find my thread on
saitekforums.com if you find a bug or would like additional features.  I have plans
for additional features, so keep watching for updated versions.

This program would be nothing without the F4SharedMemory library, by Lightning of
viperpits.org.  Thanks for the excellent work!

Special thanks to Darkcloud of saitekforum.com for pointing me in the right direction.


INSTALLATION
------------
You'll need to have both the Saitek X52 Pro drivers AND the SST programming software
installed.  These files are available from saitek.com here:
  http://www.saitek.com/uk/down/drivers.htm

Other than that, there's really nothing to do besides unzip the archive, which I
assume you've already done to read this file.  Now you can place the "Raptor007's
Falcon 4 to X52 Pro Utility" folder wherever you'd like it to be.

Keep everything together in that folder!  If F4SharedMem.dll is removed, this
utility will NOT function.  You must also keep mscvm80.dll, msvcp80.dll, msvcr80.dll,
and Microsoft.VC80.CRT.manifest (unless you have the MSVC 2005 SP1 x86 runtime version
8.0.50727.4053 installed).


NOTE FOR UPGRADING
------------------
If you'd like to keep your settings from an older version, get rid of the settings.cfg
included with this archive and put in your old settings.cfg.  The utility will import
the settings at program start and then re-save as a v1.4 settings file when you exit.


GETTING STARTED
---------------
To use this utility, simply open the exe, select the settings you want, and hit Start.
Then open Falcon 4 (if it didn't auto-launch) and enjoy!

This utility will stop responding once you hit Start; you'll have to open Falcon 4 to
wake up the program, then exit Falcon 4 to get it back to it's editable status.  In a
future verison, I may fix this with multi-threading.  Feel free to kill the task if
you need to, as it does not write to disk while running.


SETTING UP MFD PAGES
--------------------
It's pretty simple, really.  Just pick the number of pages you'd like, then for each
page, pick the data you'd like to see on that page (up to 3 lines) from the drop-down
boxes.

The text box to the left of each drop-down is the label for that data; keep these
short since you'll only have 16 characters total per line (label + info).

The page that is selected in the utility when you hit Start will be the default page
displayed once you start Falcon 4.  You can use the throttle's Page Up/Down wheel
to scroll through the pages during the game.


SETTING UP LEDS
---------------
For each LED, you'll want to set its default color first.  If you choose "Unchanged",
the utility will never send any data to the joystick for that LED, and thus cannot be
configured for condition-based coloring.

You can configure up to 9 conditions (in addition to the default state).  First pick
the condition you'd like to check for, then the color for that condition, and finally
if you'd like the LED to blink.

The order of execution is:
* Condition 1
* Condition 2
* ...
* Default Color

So if both the first and second conditions are true, the LED will use the color and
blink rate specified for Condition 1.  If all conditions are false, the default
color will be displayed.


SETTING UP AUTO-LAUNCH
----------------------
You can have Falcon 4 load automatically after you click Start.  To do this, make
sure the "Automatically Launch Falcon 4" box is checked, then click the Browse
button to select your Falcon 4 executable (for Allied Force, this is FalconAF.exe).

You can also specify command-line options.  By default, the -g5 option is present,
which extends the range of some of the graphics quality sliders in Allied Force.


TROUBLESHOOTING
---------------
If you get no lights or MFD activity after clicking Start and opening Falcon 4, you
probably need to restart the Saitek DirectOutput service.  To do this, quit Falcon 4
and click the "Restart DirectOutput" button at the top of the settings window.  It
should work properly the next time you start it.

If you get an error about DirectOutput not found or X52 Pro not found, you may need
to reinstall your Saitek X52 Pro drivers and the SST programming software.


CHANGES: v1.4 (2009-03-28)
--------------------------
* Added auto-launch feature, where the program starts Falcon 4 automatically when
  the Start button is clicked.
* Fixed an issue where the program would hog too many resources on a single-core
  CPU, preventing Falcon 4 from loading.  This fix only works when auto-launch is
  used to start Falcon 4!
* Added a button to restart the Saitek DirectOutput service.
* Updated to Lightning's F4SharedMemory v2.3.2.0.
* Updated to VC++ 2005 SP1 runtime version 8.0.50727.4053, and included the DLLs.
* Program runs at BelowNormal priority while waiting for the shared memory reader
  to recognize that Falcon 4 is ready.

CHANGES: v1.3 (2009-10-24)
--------------------------
* Added support for BMS3 and BMS4 formats.
* Changed minimum MFD pages to 1, because I can only control LEDs on my MFD pages.
* Now keeps track of all Saitek DirectOutput devices and lets you select one.
* Automatically selects X52 Pro if there are multiple Saitek DirectOutput devices.
* Many new MFD options, such as groundspeed, vector in air, and wind calculations.
* Fixed a minor bug that would cause it to jump to MFD page 1 unnecessarily when
  setting the number of MFD pages.
* Increased the height of some drop-down boxes to make them easier to use.

CHANGES: v1.2 (2009-04-13)
--------------------------
* Tweaked code to compile with Lightning's F4SharedMemory v2.0.0.0.  Hopefully this
  will improve OpenFalcon compatibility.
* Added an artificial horizon option for the MFD.
* No longer deinitializes DirectOutput when Falcon 4 exits.  Now you should not
  have to quit and reopen the utility for multiple Falcon 4 runs.
* Fixed the working directory bug; auto-save now works after manual load/save.
* Fixed a potential memory leak.
* Fixed a bug that would forget your selected MFD page if it was the last.
* Fixed a bug that would forget MFD labels sometimes.

CHANGES: v1.1 (2008-12-17)
--------------------------
* Rewrote LED code entirely, to allow multiple conditions and blinking lights.
* Added many more possible conditions for LEDs, like caution lights and RWR data.
* Added RWR and LightBit options for MFD.
* Removed "Engine Fire" conditions because I never could get it to work.
* Added save/load buttons for settings, so you can easily keep multiple setups.
* Implemented code to allow v1.1 to read settings from v1.0.
* The included settings.cfg has been updated for better MFD and LED utilization.

CHANGES: v1.0 (2008-10-31)
--------------------------
* Initial release.
